Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / PostScript Imaging Messages

GXPostScriptScanStatusText

QuickDraw GX sends the GXPostScriptScanStatusText message after getting a printer status message back from the printer to interpret and prepare the status string. You can override the GXPostScriptScanStatusText message if the status string has information you need or if the format of this string is not standard and cannot be interpreted by QuickDraw GX's default implementation. Your override of the GXPostScriptScanStatusText message must match the following
formal declaration:

OSErr MyPostScriptScanStatusText (Handle statusTextHdl);

statusTextHdl

A handle to the text returned in the GXPostScriptGetStatusText message.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXPostScriptScanStatusText message every time any text is returned from the GXPostScriptGetStatusText message (that is, when the message does not return an empty buffer). The GXPostScriptScanStatusText message performs error detection and reporting, using the Postscript scan ('scan') resource to interpret the string. Normally, the only text returned by a printer is an error. This message searches the text buffers to determine the printing status and interprets the status string to determine the state of the printing process.

The default implementation of the GXPostScriptScanStatusText message searches the text string for special keywords that determine the status of the printing device. It also reformats the string for reading by a user and calls the GXReportStatus function to display the string in the desktop printer window.

You need to override this message if the status string holds information that is meaningful only to you or if the device to which the workstation is connected has a format different from that of Apple LaserWriters. Only the Apple LaserWriter format is understood by the default implementation of this message.

SPECIAL CONSIDERATIONS

You can partially or totally override the GXPostScriptScanStatusText message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

The default implementation of the GXPostScriptScanStatusText message can also return the communications errors that are listed in Table 4-2 on page 4-42.

SEE ALSO

The GXPostScriptGetStatusText message is described on page 4-106.

The GXReportStatus function is described on page 5-17 in the chapter "Printing Functions for Message Overrides."

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help